home *** CD-ROM | disk | FTP | other *** search
/ CD School House 10 / CD School House - Education and Games (10.0) - Wayzata Technology (1995).iso / mac / DOS / MISC / RCD / RCD.DOC < prev    next >
Text File  |  1995-01-13  |  19KB  |  544 lines
  1.  
  2.  
  3.                 RCD version 2.3
  4.                 (Ray's Change Directory)
  5.             
  6.                by Ray Van Tassle
  7.                1020 Fox Run Lane
  8.              Algonquin, Ill, 60102
  9.                 (708)-658-4941
  10.                 January 10, 1995
  11.  
  12.     RCD program and manual copyright(c) 1990-1995 by Ray Van Tassle.
  13.  
  14.     Abstract: 
  15.     
  16.     RCD is a set of programs to let you change the default 
  17.     disk/directory quickly & easily, in a "do what I mean" manner.  
  18.     You can specify all or part of the name of the directory you 
  19.     want to go to, and RCD will do it's best to figure out which 
  20.     directory you mean, and on which disk.  And with the 
  21.     new systems being delivered with 500+ MB disks standard, you can 
  22.     potentially have a lot of drives, both physical & logical 
  23.     (drives in DOS extended partitions, and in STACKER & SPEEDSTOR 
  24.     compressed volumes).
  25.     Beginning with version 2.3, RCD will handle multi-gigabyte disk
  26.     farms, with thousands of directories.  It has been tested with
  27.     20,000+ directories!
  28.     
  29.     RCD is a companion (but totally independent) program to WIZ, my
  30.     lightning fast file finder.
  31.     
  32.  
  33.     RCD is shareware, NOT freeware!!!
  34.  
  35.     You are granted a limited 21 day evaluation license. At the end
  36.     of that period, you should either delete it and stop using it,
  37.     or send in the registration fee of $15.
  38.  
  39.  
  40.     QUICK-START
  41.     -----------
  42.     For a quick start, so you don't have to read this manual, 
  43.     execute "RCDSCAN".
  44.     
  45.     Then you can change to ANY directory on any disk by typing "RCD" 
  46.     and all or part of the desired directory name.
  47.  
  48.  
  49.  
  50.  
  51.     ACKNOWLEDGEMENTS--and COMPARISION TO OTHER PROGRAMS
  52.     ---------------------------------------------------
  53.     
  54.     Norton's NCD gave me the initial idea for writing RCD, along 
  55.     with ideas on improvement.  NCD will only work on the current 
  56.     disk; it has a spiffy user display, but I consider it quite 
  57.     limited in terms of looking at other disks, and weak in finding 
  58.     approximate matches on directory names.  Ledbetter's LCD is 
  59.     similar in function to RCD, but isn't quite as powerful in 
  60.     matching, is quite a bit slower in building the index (SCAN), 
  61.     and chokes on network drives that are configured, but off-line 
  62.     (I use $25NETWORK, Little Big Lan, and Fastlynx's EBOX).
  63.     
  64.     Time to build index (483 directories on 10 partitions (drives), no
  65.     disk cache, 7 MHZ 286):
  66.         RCDSCAN v2.2    LCD v4.00a    NCD v4.50
  67.         ------------    ----------    ---------
  68.         17 seconds    130 seconds    170 seconds
  69.         
  70.     LCD does have the capability to do a MD & RD within itself, and
  71.     make the corresponding change in the index file, but this must 
  72.     be invoked on the DOS command line; it doesn't work with 
  73.     directories created/deleted/renamed/moved internally within
  74.     other shells or utilities.  And RCDSCAN is so fast that it's not
  75.     a big burden to run it after modifying your directory structure.
  76.  
  77.  
  78.     Directory ordering
  79.     ------------------
  80.     In my first cut at RCD, I didn't sort the directories, but just
  81.     displayed them in arbitrary order.  This was obnoxious, so I then
  82.     sorted them alphabetically, for each disk.  This is kind of like
  83.     NCD does it, and is exactly the way that LCD does it.  But I didn't
  84.     like that either--it seemed to me that all the directories named
  85.     "FOO" should be next to one another on the display, no matter what
  86.     disk they were on.  After thinking about it some more, a light
  87.     dawned:  a disk name is really a type of "super directory", especially
  88.     when you consider large (200MB +) disks divided into several logical
  89.     partitions.  It doesn't make any more sense to group them by disk than
  90.     it does to group them by parent-directory.
  91.     
  92.     So RCD sorts the directories strictly by name, no matter what the
  93.     parent directory is (be it disk or normal directory).
  94.         
  95.     
  96.     MANUAL
  97.     ------
  98.     RCD is two programs and one data file. The programs are:
  99.         RCDSCAN - Examines your disks, and builds a data-base
  100.               containing the directory & disk names.
  101.               
  102.         RCD    - The program to use in place of CD (or CDD)
  103.     
  104.         
  105.  
  106.     Command Line format and Switches
  107.     --------------------------------
  108.  
  109.     RCD [-?] [-p] [-r] [-l] [-m] [-w] [-q] [-s] [-h] [-d] directory-name
  110.  
  111.     As usual, the stuff inside the square brackets "[]" are
  112.     optional and may be present or omitted. You do NOT include
  113.     the brackets in your command line.
  114.     The various fields and options may appear in any order, in
  115.     either upper or lower case.
  116.     The switch character can be either "-" or "/".
  117.  
  118.  
  119.  
  120.     If you just invoke RCD without any parameters, it gives you a
  121.     brief help line and shows the current disk & directory.
  122.     For more info, include '-?'.  For even more,
  123.     include '-??'.
  124.  
  125.     The parameter is all or part of the name of the directory you
  126.     want to switch to.  RCD uses the full (better than DOS) wildcard
  127.     matching that WIZ uses:  you can put "*" anywhere, and it 
  128.     matches zero or more characters, "?" matches exactly one 
  129.     character.  RCD first looks for a directory name which is
  130.     exactly the same as the parameter.  If it does not find one, it 
  131.     looks for a directory that starts with what you gave.  If it 
  132.     does not find one, it then looks for a directory with the 
  133.     characters you gave ANYWHERE in the name.  To be more precise, 
  134.     if you said "RCD xyz", the patterns it uses for the match are:
  135.         1st try: "XYZ"
  136.         2nd try: "XYZ*"
  137.         3rd try: "*XYZ*"
  138.         
  139.     However, if you include any wildcard characters ("*" or "?"), 
  140.     then RCD will assume that you know what matching pattern you 
  141.     want, and will only do one try, using the exact pattern given.
  142.     
  143.     If the directory parameter starts (or ends) with a "\", then this
  144.     is treated as if the -r (root only) or -l (leaf only) switch
  145.     was specified.
  146.     
  147.         
  148.     POPUP WINDOW
  149.     ------------
  150.     It is possible that RCD will find more than one directory that 
  151.     satisfies it (for example, I have sub-directories named TRY and 
  152.     TEMP all over my disk).  RCD will popup a scrolling window 
  153.     showing all the matching directory names.  The cursor will be 
  154.     positioned as follows: If the current directory is NOT a match, 
  155.     the cursor will be on the first line. If the current directory 
  156.     IS a match, then the cursor will be on the next line after the 
  157.     current directory.
  158.     
  159.     You can scroll thru the list using the UP/DOWN arrows, and
  160.     PAGEUP, PAGEDOWN, HOME, and END.  Hit ENTER to switch to the
  161.     highlighted directory. Hit ESC or CTRL/C to bail out.
  162.     
  163.     RCD recognizes when your display is set for more than 25 lines
  164.     (43, 50, or other), and adjusts the number of lines in the window
  165.     appropriately.
  166.     
  167.     
  168.  
  169.      -l    Leaf directory
  170.      --------------------
  171.     This switch says to only consider a directory that is a leaf 
  172.     (does not have any sub-directories below it).
  173.     
  174.     -p    Parent directory
  175.     ----------------------
  176.     This is the opposite of -l.  It says to only consider a 
  177.     directory if it DOES have at least one sub-directory.
  178.     
  179.     -r    Root directory
  180.     --------------------
  181.     This says to only consider a directory if it is at the highest 
  182.     level--it's in the root directory of a disk.
  183.  
  184.     -m    Monochrome display
  185.     ------------------------
  186.     Use this to force a black & white display window.  You may also
  187.     force mono by putting "/m" in the WIZ environment variable.    
  188.     
  189.     -w    Don't do popup window
  190.     ---------------------------
  191.     Don't do a popup window if there are several matching 
  192.     directories.  Instead, just switch to the "next" directory 
  193.     (according to the rules of positioning the cursor discussed 
  194.     above.)  If you re-execute the exact same RCD command, it will 
  195.     step thru all the matching directories in sequence.
  196.     
  197.     -s    Re-scan the disks before the directory search
  198.     ---------------------------------------------------
  199.     This forces a rescan of the default disks.  In point of fact,
  200.     this spawns the command "RCDSCAN".
  201.  
  202.     -h    Specify home directory for the index file
  203.     -----------------------------------------------
  204.     See the section under RCDSCAN.
  205.  
  206.     -d    Prefix for index file name
  207.     --------------------------------
  208.     See the section under RCDSCAN.  This option is mainly useful
  209.     for keeping separate index files for removable disks, such
  210.     as CD-ROMs or network disks.
  211.     
  212.     -q    Quick scan of one disk
  213.     ----------------------------
  214.     This does a quick scan of just one disk, then does the directory 
  215.     search.  If a disk was specified, it will scan that disk.  If 
  216.     not, it will scan the current default disk UNLESS that disk was 
  217.     previously scanned and is in the RCD.IDX index file.
  218.     This is particularly useful for changing to a directory on a
  219.     removable disk (CD-ROM, floppy, or network drive), where it would 
  220.     not be meaningful to include that drive in your "standard" list 
  221.     of drives to keep in the index.
  222.     Quickscan does NOT update the data-base index file.  You will
  223.     have to do either "RCDSCAN" or "RCD -s" for that.
  224.     
  225.     Example:    RCD -q z:doom
  226.     
  227.     Automatic quickscan
  228.     -------------------
  229.     If the default drive (or specified drive) is not in the index,
  230.     then RCD will automatically do a quickscan of that disk, UNLESS 
  231.     it is a CD-ROM, SUBST'ed, or network drive.  The reason that I
  232.     do not automatically scan these is because access to these
  233.     drives might be slow.
  234.     
  235.     
  236.   *************************************************************************
  237.  
  238.     RCDSCAN [-v] [-?] [-h index_path] [-d index_file_prefix] [disks]
  239.     ----------------------------------------------------------------
  240.  
  241.     You need to run RCDSCAN whenever you add, delete, move, or 
  242.     rename directories and/or drives.  It builds a data-base (index) 
  243.     file containing information about your disks and directory 
  244.     structure. The data base is sorted in alphabetical order, so 
  245.     when RCD shows several matching files, they will be in order, 
  246.     but by the name of the matching directory, NOT in tree order or 
  247.     in sorted order by directory level.
  248.     By default, this file is: "C:\RCD.IDX" (but see the -h flag).
  249.     
  250.     
  251.     Disk(s):
  252.     ---------------------------
  253.     You can specify the disk(s) you want it to scan, optionally
  254.     followed by ":".  It will look at those drives, in the order
  255.     you listed them.  If you list the same one twice, it will look
  256.     at it twice.  You can specify a range of disks by using a
  257.     dash--"C-F" is the same as "CDEF".
  258.     
  259.     CURRENT DISK--- If you start off with ":", rather than a [set of]
  260.     disk letter(s), then RCD will restrict itself to the current drive.
  261.     Example:      RCD :try  -- will look only on the current disk
  262.  
  263.  
  264.     If you don't list any disks, it will look at all drives 
  265.     beginning with C. It will stop when it hits a drive that it 
  266.     cannot read.
  267.  
  268.     Processing Disk(s) and Environment Variable 
  269.     -------------------------------------------
  270.     
  271.     You can override the disks that RCDSCAN looks at, and their 
  272.     order, by making an environment variable "WIZ".  Do: "SET 
  273.     WIZ=floppy-disk-list:hard-disk-list". Example: "SET WIZ=AB:C-M".  
  274.     What actually happens is that RCDSCAN will try to read all the 
  275.     disks to the left of the colon, then all those to the right of 
  276.     the colon.  Those on the left are deemed to be floppies, and 
  277.     will be ignored.  Those on the right are deemed to be hard 
  278.     drives, and it will quit on the first one that it can't read.
  279.  
  280.     You may omit the "default" disk set by leaving a space after
  281.     the "=".  This is most useful when you need only to put the
  282.     "/M" switch, as: "SET WIZ= /M".
  283.     
  284.     If you specify disks on the command line, it will try to read
  285.     them all, even if it can't read one.
  286.  
  287.     The list may be discontiguous, (e.g., "C-FL-M").  This is
  288.     mostly useful if you are on a network, which tends to make
  289.     the networked disks at the higher letters, and leaves a hole
  290.     before them.
  291.     
  292.  
  293.  
  294.     Pre-defined Drive Sets
  295.     ----------------------
  296.     You can actually have several pre-defined sets of disks to
  297.     search. If the disk-specifier on the command line is a single
  298.     digit (0-9), it will look for that specifier in the WIZ
  299.     variable.  For example, you might say:
  300.         "SET WIZ=AB:C-F  1=CDEG 2=AB:  3=C-Z 4=C-Z:"
  301.  
  302.     As above, those to the left of the colon are deemed floppies; 
  303.     those to the right are hard drives, and RCDSCAN will quit if it 
  304.     can't read one. However, if there isn't a colon, then they are 
  305.     ALL deemed to be hard drives.
  306.  
  307.     The command "RCDSCAN ", will look on ABCDEF.
  308.     The command "RCDSCAN 1:", will look on CDEF.
  309.     The command "RCDSCAN 2:", will look on AB.
  310.     The command "RCDSCAN 3:", will look on all drives C-Z (and
  311.         will quit at the first on that it can't read).
  312.     The command "RCDSCAN 4:", will look on all drives C-Z (and it
  313.         will attempt to read each and every one of them).
  314.     The command "RCDSCAN 9:", will give an error message.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.     -v    Verbose
  321.     -------------
  322.     If you have this flag once, RCDSCAN will print the disk name when
  323.     it starts as it starts on a disk.  If you have it twice
  324.     (-vv), it will also print the name of each directory.
  325.     This is mostly useful for troubleshooting, or to see a 
  326.     progress indication.
  327.     
  328.     -h index-file-path
  329.     ------------------    
  330.     By default, this index file is: "C:\RCD.IDX".  If, for some 
  331.     reason, you want it to be somewhere else than "C:\", you can use 
  332.     the -h flag (or /H on the WIZ environment variable) to put it 
  333.     where you want.  This might be useful if your C drive is a 
  334.     network disk.  You will probably prefer to set this in the WIZ 
  335.     environment variable.
  336.     
  337.     Example:   
  338.         RCDSCAN -hD:\DEADEND
  339.         or
  340.         SET WIZ ab:c-j /hD:\deadend
  341.     
  342.     -d index-filename-prefix
  343.     --------------------
  344.     By default, the index filename is "RCD.IDX" (not counting the path).
  345.     This is fine for non-removable hard disk(s), but what if you have
  346.     some large removable disks--such as CD-ROMs?  This option will 
  347.     let you keep a separate directory index file for them.  Just pick
  348.     a unique prefix for each CDROM disk you want to have RCD
  349.     manage for you.  The prefix must be 5 characters or less.
  350.     
  351.     
  352.  
  353.  
  354.             
  355.     
  356.     
  357.     It has been tested, and works, with DOS 3.x, including Zenith 
  358.     DOS 3.30, DOS 3.31, DOS 4.01, DOS 5.0, DOS 6.0, STACKER and 
  359.     DoubleSpace compressed pseudo-disks, and On-Track partitioning
  360.     software.  DOS 3.31, 4.01, and 5.0 have large (greater than 32MB)
  361.     partitions with more than 65,536 sectors. Zenith DOS 3.30 and 
  362.     On-Track have large partitions by virtue of using large 
  363.     sectors (1024, 2048, or 4096 bytes, rather than 512 bytes).
  364.  
  365.     
  366.  
  367.     
  368.  
  369.     Error Messages
  370.     --------------
  371.         "Can't tell if FAT-12 or FAT-16. Assuming FAT-16!"
  372.         Just what it says.  I've only seen this on networked
  373.         disk drives.  If you know how to RELIABLY tell what
  374.         type of FAT a disk has (other than going thru DOS),
  375.         please let me know.
  376.  
  377.     "malloc failed for FAT_buf!"
  378.         Can't allocate memory to read a FAT block.  Most
  379.         likely an internal error.
  380.  
  381.      "malloc failed for dir_sec_buf!"
  382.         Can't allocate memory to read in a directory sector.
  383.         Most likely an internal error.
  384.  
  385.     "Sorry, out of memory!!!"
  386.         You lose.
  387.  
  388.     "Can't open file:"
  389.         Failure to open an archive file.  Most likely a disk
  390.         error. Run CHKDSK.
  391.  
  392.     "Non-existant directory, you should run RCDSCAN!"
  393.         A directory is in the data-base, but does not exist on
  394.         the disk.  It was probably renamed or deleted, but you
  395.         didn't run RCDSCAN after doing so.
  396.  
  397.     BUGS
  398.     ----
  399.     No known bugs.  However, RCDSCAN mostly does not use DOS to
  400.     process a disk, so errors on my part, or a change in the disk
  401.     structure might break it.
  402.  
  403.     If you are having problems, try 1) use the "-v" switch, to
  404.     isolate the error to a specific disk,  2) use "-vv", to see
  405.     as it hits each sub-directory.  Then call or write me.
  406.  
  407.  
  408.     Coming Attractions
  409.     ------------------
  410.     * Ability to create, delete, rename, and move directories.    
  411.     * Plus other things I think of, or get suggested.
  412.  
  413.     This is shareware, so I'm probably more interested and 
  414.     receptive in hearing comments and suggestions than a commercial 
  415.     software publisher would be.  Just send them in, or give me a 
  416.     call.  I can't promise to fix bugs, or add specific features, 
  417.     but I'll listen to everything.  Even if you're cheap and 
  418.     haven't registered.
  419.  
  420.     
  421.     BBS Support & New Versions
  422.     --------------------------
  423.     There is no "official" support BBS.  However, I frequent these
  424.     local BBS's:
  425.         Chicken Coop      (708)658-1545   RIMENET =>THECOOP
  426.         Emporium          (708)551-4275   Fidonet 1:/115/551
  427.         Rainbow Draggin'  (708)854-1696   Spare phone line
  428.                           in my basement.
  429.  
  430.     Update History
  431.     --------------
  432.  
  433.     1.4   1/12/92
  434.         * Initial public release
  435.     
  436.     1.5   2/26/92
  437.         * Changed to scrollable window display
  438.     
  439.     1.6   3/18/92
  440.         * Check & report disk read error.
  441.     
  442.     1.7   4/27/93
  443.         * Support for network drives
  444.         * leading :, for current drive only
  445.         * Fixed bug which sometimes left blank lines.
  446.         * Leading/trailing "\"
  447.         
  448.     1.9   8/5/93
  449.         * Old bug--didn't restore cursor shape properly (RCD).
  450.         * Fixed bugs with mono detection.
  451.         * Size window to number of matches.
  452.         * Fixed RCDSCAN - Would sometimes quit immediately.
  453.  
  454.     2.0    Was never released.
  455.  
  456.     2.1   1/25/94
  457.         * Now checks for valid directories & directory structure.
  458.         * Fixed a bug in processing large DUBLSPACE disks (DOS 6.0).
  459.         * Fixed bug in window size & [sometimes] blanked out lines.
  460.     
  461.     2.2  4/27/94
  462.         * Added -q and autoquickscan
  463.         * Fixed a window bug with DesqView
  464.         * Added -h, to place the index file somewhere other
  465.             than C:\
  466.     2.3  1/10/95
  467.         * Added -d option
  468.         * Fixed problem with RCDSCAN & RCD running out of memory 
  469.           on HUGE disks (over 2400 directories).  Now handles 20,000+.
  470.         * Fixed window painting bug
  471.     
  472.  
  473.  
  474.  
  475.  
  476.                            --------------------------
  477.                              INVOICE / REGISTRATION
  478.                            --------------------------
  479.  
  480.  
  481.  
  482.           Sold to: ___________________________________________________
  483.  
  484.                    ___________________________________________________
  485.  
  486.                    ___________________________________________________
  487.  
  488.  
  489.              Date: ______________________________
  490.  
  491.  
  492.           ============================================================
  493.  
  494.  
  495.     I will normally send you the latest version on 5 1/4" disk.
  496.     Add $2 for 3 1/2" disk. (Net $22)
  497.     Delete $5 (per copy) if you DON'T want me to send you a disk!
  498.  
  499.           _____ copies of WIZ version ___ at $20 each $____________
  500.  
  501.           _____ copies of RCD version 2.3 at $20 each $____________
  502.  
  503.           _____ add $2 for 3.5" disk              $____________
  504.  
  505.       _____ delete $5 per copy for no disk (net $15)
  506.  
  507.         DISCOUNT for registering both is
  508.         $5 off.                  ____________
  509.  
  510.  
  511.  
  512.                                 TOTAL ENCLOSED.......  $____________
  513.     NOTE:
  514.     If you have the current version, I will send you
  515.     a disk with the NEXT version, when I release it,
  516.     unless you check here:
  517.  
  518.     Ray, YES, send me a disk NOW, even though I already
  519.     have the current version:  [__]
  520.  
  521.  
  522.  
  523.  
  524.       Where did you get your copy of RCD?
  525.       Shareware distributor name:___________________
  526.       BBS name: ____________________
  527.       BBS phone #:  ____________________
  528.  
  529.  
  530.                       Send this invoice and your check to:
  531.  
  532.                 Ray Van Tassle
  533.                 1020 Fox Run Lane
  534.                 Algonquin, Il. 60102
  535.                 (708)-658-4941
  536.  
  537.  
  538.  
  539.  
  540.           =============================================================
  541.  
  542.           Thank you for your support ............... Ray Van Tassle
  543.  
  544.